home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / tools / desktop / thing / tos2gem / tos2gem.txt < prev   
Encoding:
Text File  |  1995-11-25  |  17.9 KB  |  380 lines
  1.     Kurzinformationen zu TOS2GEM vom 21.06.1995, Stand: 21.06.1995
  2.     --------------------------------------------------------------
  3.  
  4.     (An English version of this text will be available soon!)
  5.  
  6.  
  7.     1. Was ist TOS2GEM?
  8.     -------------------
  9.  
  10.     TOS2GEM ist ein Programm für den AUTO-Ordner, das es GEM-Applikationen 
  11.     auf flexible Weise ermöglicht, die Ausgaben von .TOS bzw. .TTP-
  12.     Programmen in ein Fenster umzulenken, was durch Benutzung von VDI-
  13.     Textbefehlen erreicht wird. Somit können Programmierer von Shells oder 
  14.     alternativen Desktops ohne großen Aufwand eine Art Console-Fenster 
  15.     einrichten.
  16.  
  17.     Dadurch ergibt sich natürlich, daß TOS2GEM hauptsächlich für den 
  18.     Einsatz unter SingleTOS gedacht ist. Allerdings läuft es auch unter 
  19.     Geneva, MagiC und MultiTOS, wobei hier natürlich der Nutzen sehr 
  20.     eingeschränkt ist, da die TOS-Programme unter diesen Systemen sowieso 
  21.     in Fenstern laufen (wenn sie richtig gestartet werden).
  22.  
  23.     Die wichtigsten Eigenschaften von TOS2GEM auf einen Blick:
  24.     - bietet saubere Möglichkeit für Programmierer, Ausgaben von 
  25.       nachgestarteten TOS-Programmen in ein GEM-Fenster zu lenken
  26.     - simuliert TOS-Bildschirme beliebiger Größe (also nicht nur 
  27.       langweilige 80x25), die auch nur teilweise sichtbar sein dürfen
  28.     - arbeitet mit allen nicht-proportionalen Zeichensätzen in beliebiger 
  29.       Größe zusammen
  30.     - mit (optionaler) Ausgabepufferung teilweise schnellere Ausgabe als 
  31.       mit GEMDOS/BIOS (nur für SingleTOS/MagiC)
  32.     - bietet auf Wunsch einen Puffer für ältere Ausgaben ("Scrollback")
  33.     - hat vollständige VT52-Emulation (Farbsequenzen nur optional)
  34.  
  35.  
  36.     2. Wie wird's installiert?
  37.     --------------------------
  38.  
  39.     TOS2GEM.PRG wird einfach in den AUTO-Ordner der Bootpartition kopiert 
  40.     und richtet dann bei jedem Booten einen Cookie ein, über den 
  41.     Programmierer die Benutzung von TOS2GEM steuern können. Bei Bedarf kann 
  42.     TOS2GEM.PRG aber auch vom Desktop gestartet werden.
  43.  
  44.  
  45.     3. Was ist T2GRESET.PRG?
  46.     -------------------------
  47.  
  48.     Programme müssen TOS2GEM für sich reservieren; bis zur Freigabe können 
  49.     andere Programme die Dienste von TOS2GEM nicht in Anspruch nehmen. 
  50.     Sollte nun ein Programm, das TOS2GEM für sich reserviert hatte, 
  51.     abstürzen oder am Ende die Freigabe vergessen, kann durch Aufruf von 
  52.     T2GRESET diese Blockade aufgehoben werden. Es ist nicht sehr ratsam, 
  53.     T2GRESET aufzurufen, wenn die Applikation, die TOS2GEM reserviert hat, 
  54.     noch läuft, da es dann zwangsläufig zu schweren Komplikationen kommt. 
  55.     Kennzeichen für eine vorliegende Blockade ist, wenn kein Programm 
  56.     läuft, das TOS2GEM benutzt und ein neu gestartetes meldet, es könne die 
  57.     Reservierung nicht vornehmen.
  58.  
  59.  
  60.     4. Was sind T2G_BSP.PRG und PRIMZAHL.TOS?
  61.     -----------------------------------------
  62.  
  63.     Da sich anhand der theoretischen Beschreibung der Funktionsweise von 
  64.     TOS2GEM wohl niemand genau ein Bild davon machen kann, was TOS2GEM 
  65.     eigentlich macht, habe ich ein kleines Beispielprogramm geschrieben 
  66.     (eben T2G_BSP.PRG oder ausgeschrieben TOS2GEM-Beispiel). Die beiden 
  67.     Dateien sind im kleinen Archiv (siehe Punkt 8) übrigens nicht enthalten!
  68.  
  69.     Nach dem Start des Programms (TOS2GEM muß natürlich vorher gestartet 
  70.     worden sein) erscheint eine Dialogbox, in der man die Ausmaße des von 
  71.     TOS2GEM zu simulierenden TOS-Bildschirms angibt und wieviel davon 
  72.     maximal sichtbar sein soll. Außerdem kann hier gewählt werden, ob und 
  73.     wie die Ausgabepufferung und die Farbunterstützung von TOS2GEM benutzt 
  74.     werden sollen. Im Anschluß wird ein entsprechendes Fenster geöffnet, in 
  75.     das (bereits per TOS2GEM-Umlenkung) die realisierten Ausmaße 
  76.     geschrieben werden. Direkt danach wird das Programm PRIMZAHL.TOS (das 
  77.     sich daher im gleichen Verzeichnis befinden muß) gestartet, das eine 
  78.     simple Primzahlberechnung mit dem "Sieb des Eratosthenes" realisiert 
  79.     (man kann auch jedes andere TOS-Programm nehmen, es muß nur als 
  80.     PRIMZAHL.TOS im richtigen Verzeichnis stehen). Nach Ende des 
  81.     Primzahlprogramms kann man das Fenster, in das die Ausgaben ja sauber 
  82.     umgelenkt wurden, nach Lust und Laune auf dem Bildschirm plazieren. Ein 
  83.     Druck auf den Closer beendet das Programm, nach einem Klick in den 
  84.     Arbeitsbereich des Fensters erscheint eine Alertbox mit drei 
  85.     Wahlmöglichkeiten: "Resize" erlaubt eine Änderung der TOS2GEM-
  86.     Bildschirmgröße (mit dem gleichen Dialog wie zu Beginn; dabei wird der 
  87.     Bildschirm gelöscht, wenn seine Gesamtgröße verändert wird). Mit 
  88.     "Rerun" kann nochmal PRIMZAHL.TOS gestartet werden und "Nichts" macht 
  89.     genau dies...
  90.  
  91.     Das Beispielprogramm ist bewußt einfach gehalten, u.a. damit man sieht, 
  92.     daß eine TOS2GEM-Unterstützung relativ einfach möglich ist. Es werden 
  93.     nicht alle Möglichkeiten von TOS2GEM demonstriert (insbesondere werden 
  94.     weder verschiedene Zeichensätze in unterschiedlichen Größen benutzt 
  95.     noch ein "Scrollback" geboten), allerdings sollte es trotzdem gut 
  96.     verdeutlichen, welche Möglichkeiten TOS2GEM bietet. Wer den Quellcode 
  97.     haben möchte, um sich mal ein konkretes Bild von der TOS2GEM-
  98.     Unterstützung machen zu können, soll sich bitte melden (siehe unten). 
  99.     Da der Source inzwischen ausführlich kommentiert wurde und einige 
  100.     Libraryfunktionen direkt eingebunden wurden, damit er eigenständig 
  101.     compiliert werden kann, ist seine Größe inzwischen auf stattliche 40 
  102.     Kilobyte angewachsen. Allerdings ist dabei der Anteil dessen, was nur 
  103.     für die TOS2GEM-Unterstützung nötig ist, relativ gering (die Kommentare 
  104.     nicht mitgerechnet), also nicht erschrecken...
  105.  
  106.  
  107.     5. Die Doku für Programmierer
  108.     -----------------------------
  109.  
  110.     Ich habe mich entschlossen, den Hypertext mit Informationen (nicht nur) 
  111.     für Programmierer in seiner immer noch unvollständigen Fassung 
  112.     freizugeben, da er inzwischen halbwegs brauchbar sein dürfte. Zum 
  113.     Anschauen benötigt man den ST-Guide von Holger Weets, dem ich an dieser 
  114.     Stelle nochmal ganz herzlich für diese großartige Tool danken möchte.
  115.  
  116.     Zusätzlich zur Hypertext-Doku kann auch ein Blick in die ST-Computer 04/
  117.     95 und 05/95 sicher hilfreich sein.
  118.  
  119.     Darüberhinaus sei jedem angeraten, sich einmal die TOS2GEM-Library von 
  120.     Dirk Klemmt (klemmt@informatik.uni-frankfurt.de) für Pure und Gnu C 
  121.     anzusehen, da sie die Benutzung von TOS2GEM zum Kinderspiel macht. 
  122.     Einen kurzen Überblick über ihre Fähigkeiten kann man in der ST-
  123.     Computer 05/95 erhalten. Wer mehr wissen will, wendet sich bitte direkt 
  124.     an Dirk, da ich mit der Library selbst wenig bis nichts zu tun habe.
  125.  
  126.  
  127.     6. INSPECT.TTP
  128.     --------------
  129.  
  130.     Dieses kleine Progrämmchen dient als Hilfe für Programmierer, die 
  131.     Applikationen mit TOS2GEM-Unterstützung schreiben wollen. Näheres dazu 
  132.     findet sich im Hypertext.
  133.  
  134.  
  135.     7. Rechtliches
  136.     --------------
  137.  
  138.     TOS2GEM wurde mit großer Sorgfalt programmiert und eingehend getestet. 
  139.     Es ist jedoch nicht auszuschließen, daß es noch Fehler enthält. Ich 
  140.     kann daher weder für die einwandfreie Funktionsfähigkeit von TOS2GEM, 
  141.     noch für dessen Tauglichkeit für einen bestimmten Zweck garantieren.
  142.  
  143.     Desweiteren erfolgt die Benutzung von TOS2GEM auf eigene Gefahr! Ich 
  144.     übernehme keinerlei Haftung für Schäden, die direkt oder indirekt aus 
  145.     der sach- oder unsachgemäßen Anwendung von TOS2GEM resultieren.
  146.  
  147.     Gleiches gilt selbstverständlich auch für die anderen im Archiv 
  148.     enthaltenen Programme.
  149.  
  150.  
  151.     8. Zum Kopieren von TOS2GEM
  152.     ---------------------------
  153.  
  154.     TOS2GEM ist frei kopier- und benutzbar. Allerdings darf die Weitergabe 
  155.     nur in folgenden zwei Varianten erfolgen, wobei jeweils alle 
  156.     angegebenen Dateien unverändert kopiert werden müssen (Archivierung ist 
  157.     erlaubt):
  158.  
  159.     a) Komplettpaket
  160.     Enthält TOS2GEM.PRG, T2GRESET.PRG, TOS2GEM.H, TOS2GEM.TXT, T2G_BSP.PRG, 
  161.     PRIMZAHL.TOS, INSPECT.TTP sowie TOS2GEM.HYP und TOS2GEM.REF. Dieses 
  162.     Paket ist hauptsächlich für die alleinige Weitergabe von TOS2GEM 
  163.     gedacht (wenn es also nicht einem anderen Programm beigelegt ist).
  164.  
  165.     b) Minipaket
  166.     Enthält nur TOS2GEM.PRG, T2GRESET.PRG und TOS2GEM.TXT. Diese Variante 
  167.     sollte nur dann gewählt werden, wenn man TOS2GEM als Zugabe zu einem 
  168.     Programm benutzen will, das es benötigt.
  169.  
  170.     Wer eigene Programme entwickelt hat, die TOS2GEM benötigen bzw. 
  171.     unterstützen, darf TOS2GEM seinem Programmpaket beilegen (in einer der 
  172.     beiden o.g. Formen), wenn er folgendes beachtet:
  173.  
  174.     - TOS2GEM muß in einen eigenen Ordner kopiert werden
  175.     - In der Dokumentation oder im Programm muß ein Hinweis auf die 
  176.       Benutzung von TOS2GEM erfolgen
  177.     - In der Dokumentation muß deutlich erkennbar sein, daß es sich bei 
  178.       TOS2GEM um ein eigenständiges, von mir entwickeltes Utility handelt, 
  179.       das nicht zum eigentlichen Programm gehört.
  180.  
  181.     Außerdem wäre ich für die Zusendung eines Exemplars des Programms sehr 
  182.     dankbar.
  183.  
  184.  
  185.     9. Kontakt mit dem Autor
  186.     ------------------------
  187.  
  188.     Wer Fehler gefunden hat, den Beispiel-Source möchte, Hilfe bei der 
  189.     Programmierung von TOS2GEM-Applikationen benötigt, Lob, Kritik und/oder 
  190.     Vorschläge loswerden oder einfach nur mit mir "reden" möchte, kann sich 
  191.     an folgende Adressen wenden:
  192.  
  193.     Thomas Binder
  194.     Johann-Valentin-May-Straße 7
  195.     64665 Alsbach-Hähnlein
  196.     Deutschland
  197.  
  198.     InterNet: binder@rbg.informatik.th-darmstadt.de
  199.     IRC: Gryf
  200.  
  201.     Wer den ausführlich kommentierten Sourcecode zum TOS2GEM-Beispiel haben 
  202.     will, sollte mir entweder einen adressierten und frankierten 
  203.     Rückumschlag samt Diskette zusenden, oder in der Lage sein, Binaries 
  204.     per EMail zu empfangen.
  205.  
  206.     Da TOS2GEM einen nicht unerheblich Teil meiner Freizeit beansprucht hat 
  207.     und wohl auch weiter beanspruchen wird, bitte ich um Spenden, die mir 
  208.     meine Arbeit honorieren und so gleichzeitig die Weiterentwicklung von 
  209.     TOS2GEM sichern (dies richtet sich insbesondere, aber nicht 
  210.     ausschließlich, an diejenigen, die TOS2GEM in eigenen Programmen 
  211.     unterstützen wollen).
  212.  
  213.     Meine Bankverbindung lautet:
  214.     Dresdner Bank AG Frankfurt am Main
  215.     Konto-Nummer: 9 024 050 00
  216.     Bankleitzahl: 500 800 00
  217.  
  218.     Vielen Dank!
  219.  
  220.  
  221.     10. Welche Programme unterstützen TOS2GEM?
  222.     ------------------------------------------
  223.  
  224.     Bislang gibt es drei Programme, die per TOS2GEM die Ausgaben von TOS-
  225.     Programmen in ein Fenster umlenken:
  226.  
  227.     - Die POVShell von Dirk Klemmt (klemmt@informatik.uni-frankfurt.de) ab 
  228.       Version 1.3
  229.     - Der alternative Desktop Thing von Arno Welzel (aw@zaphot.augusta.de)
  230.     - Die Shell Easy-PGP von Manfred Ssykor (msy@lafp.tng.oche.de)
  231.  
  232.     Außerdem haben sich bereits weitere Interessenten gemeldet, die ihre 
  233.     Programme mit TOS2GEM-Unterstützung ausstatten wollen. Näheres kann ich 
  234.     dazu aber erst sagen, wenn es 100%ig feststeht.
  235.  
  236.     Bei der Gelegenheit nochmal ein öffentlicher Aufruf an alle, die sich 
  237.     bisher die Doku haben schicken lassen: Meldet Euch doch mal! Etwas mehr 
  238.     Feedback wäre mir sehr recht, damit ich weiß, ob und wenn ja was für 
  239.     Sachen Ihr mit TOS2GEM-Unterstützung programmiert.
  240.  
  241.  
  242.     11. Danksagungen
  243.     ----------------
  244.  
  245.     Folgende Leute hatten, direkt oder indirekt, Anteil an der Entwicklung 
  246.     von TOS2GEM (alphabetische Reihenfolge):
  247.  
  248.     - Alexander Clauss
  249.     - Joe Conner
  250.     - Frank Danapfel
  251.     - Dirk Klemmt
  252.     - Harald Schönfeld
  253.     - Thomas Schulze
  254.     - Manfred Ssykor
  255.     - Arno Welzel
  256.  
  257.  
  258.     12. Ausblick in die weitere Entwicklung von TOS2GEM
  259.     ---------------------------------------------------
  260.  
  261.     Bislang gibt es Probleme, wenn man TOS2GEM und Gemini zusammen benutzt 
  262.     (nicht grundsätzlich, aber in bestimmten Situationen, siehe Hypertext). 
  263.     Dies zu umgehen wird das nächste Ziel sein.
  264.  
  265.     Wenn ich danach nichts besseres zu tun habe, werde ich vielleicht 
  266.     versuchen, TOS2GEM beizubringen, auch in teilweise verdeckten Bereichen 
  267.     auszugeben. Allerdings habe ich bisher keine Idee, wie ich das Ganze 
  268.     schnell *und* ohne kurze Phasen mit Zeichenfehlern machen soll.
  269.  
  270.     Ach ja, die Doku sollte ich vielleicht auch mal fertig schreiben...
  271.  
  272.  
  273.     13. History
  274.     -----------
  275.  
  276.     In der History sind nur die Änderungen ab der letzten Pre-Release-Beta-
  277.     Version von TOS2GEM enthalten, da es sonst etwas länglich würde...
  278.  
  279.     TOS2GEM vom 21.06.1995:
  280.     - Neues Cookie-Element stats, in dem bei inaktiver Ausgabeumlenkung 
  281.       die Inhalte einiger internen Variablen abgelegt werden, wo sie dann 
  282.       später wieder ausgelesen werden (mehr dazu in der Doku)
  283.  
  284.     TOS2GEM-Beta vom 01.06.1995:
  285.     - Beim Initialisieren des Textpuffers wurde vergessen, die Nullbytes
  286.       für das Zeilenende zu setzen (die Sourcezeile ist wohl beim Einbau
  287.       des Farbsupports verlorengegangen...)
  288.  
  289.     TOS2GEM-Beta vom 11.05.1995
  290.     - Bösen Fehler unter MiNT entfernt: Durch eine Unachtsamkeit im Source 
  291.       wurde unter MiNT doch gepuffert, obwohl dort ja die Erkennung von 
  292.       Eingaben nicht klappt.
  293.     - TOS2GEM kann jetzt auch zeitgesteuerte Ausgabepufferung, dabei 
  294.       erfolgt der Refresh im vorgegebenen Zeitintervallen. Erreicht wird 
  295.       dies durch negative Werte im Cookie-Element buffer_output.
  296.     - Der Zeilenredraw im Farbmodus wurde auf die "flackerfreie" Methode 
  297.       umgestellt, die zwar etwas langsamer, dafür aber augenfreundlicher 
  298.       ist.
  299.  
  300.     TOS2GEM-Beta vom 07.04.1995
  301.     - TOS2GEM kann jetzt auch die Farbsequenzen (wozu ich auch die zum 
  302.       Invertieren zähle)! Das neue Cookie-Element color bestimmt dabei die 
  303.       Art der Farbunterstützung (kompatibel oder VDI-konform). Näheres dazu 
  304.       in der .HYP-Doku, die ja jetzt freigegeben ist.
  305.     - Unter SingleTOS benutzt TOS2GEM jetzt bei Ausgabepufferung zusätzlich 
  306.       bei Bconstat-Aufrufen einen Timer, der nach 500ms einen Refresh 
  307.       auslöst. Damit funktionieren auch TOS-Programme, die die Tastatur per 
  308.       Bconstat/Bconin abfragen, korrekt (z.B. SYSOK). Unter MagiC ist das 
  309.       nicht nötig, da hier sowieso bei jedem Bconstat-Aufruf der Puffer 
  310.       geleert wird.
  311.  
  312.     TOS2GEM vom 24.03.1995
  313.     - Da mir in einem Bugreport berichtet wurde, daß der TOS2GEM-Cookie 
  314.       auch nach einem Reset noch vorhanden ist, klinkt sich TOS2GEM jetzt 
  315.       auch dann in den Reset-Vektor ein, um den Cookie-Pointer zu löschen, 
  316.       wenn es den Cookie-Jar nur erweitern mußte. Hoffentlich ist das 
  317.       Problem damit behoben (ich konnte es nicht nachvollziehen).
  318.     - Bei aktiver Ausgabepufferung wird jetzt auch dann ein "Refresh" 
  319.       durchgeführt, wenn sich der Bildschirminhalt (intern) um seine 
  320.       vertikale Größe verschoben hat. Auf diese Weise werden keine Ausgaben 
  321.       mehr komplett verschluckt.
  322.  
  323.     TOS2GEM-Beta vom 02.02.1995
  324.     - Jetzt klappt das Erkennen von Tastatur-Eingaben auch unter MagiC, 
  325.       also ist die Pufferung auch mit diesem Betriebssystem möglich. Leider 
  326.       geht es nicht mit MiNT/MultiTOS (hier wird man aber sowieso zugunsten 
  327.       von TOSWIN/MINIWIN auf TOS2GEM verzichten, was natürlich auch für 
  328.       VT52 unter MagiC gilt)
  329.     - Die Pufferung konnte nochmals verbessert werden, so daß die Ausgabe 
  330.       etwas mehr als doppelt so schnell als ohne Pufferung erfolgt (das ist 
  331.       zum Teil schneller als die Standard-GEMDOS/BIOS-Ausgabe)
  332.  
  333.     TOS2GEM-Beta vom 31.01.1995(?)
  334.     - Durch das neue Cookie-Element buffer_output kann eine Pufferung der 
  335.       Ausgabe erzielt werden, was einen deutlichen Geschwindigkeitsgewinn 
  336.       bringt. Leider klappt das nur mit SingleTOS, weil TOS2GEM nur dort 
  337.       korrekt Eingaben von der Tastatur erkennen kann (in diesem Fall muß 
  338.       ja der Puffer geleert werden, damit man sieht, was man überhaupt 
  339.       eingeben soll)
  340.  
  341.     TOS2GEM vom 19.01.1995
  342.     - Mußte TOS2GEM den Cookie-Jar anlegen oder erweitern, ging dieser 
  343.       bei der ersten Aktivierung der Ausgabeumlenkung verloren, da er im 
  344.       gleichen Speicherbereich wie die VDI-Arrays lag.
  345.  
  346.     TOS2GEM vom 03.01.1995
  347.     - Bei der Reaktivierung der Ausgabebumlenkung mittels switch_output 
  348.       wurde y_offset nicht korrekt angepaßt. Da dies ein nicht 
  349.       unerheblicher Fehler war, ist es ratsam, in Programmen, bei denen das 
  350.       TOS2GEM-Fenster in der Größe geändert werden kann, mindestens diese 
  351.       TOS2GEM-Version vorauszusetzen (Cookie-Element date beachten!)
  352.     - TOS2GEM.PRG hat jetzt wieder das Speicherschutzflag "Global" (hatte 
  353.       ich das letzte Mal vergessen, weil der Pure C-Linker das ja leider 
  354.       nicht kann (zumindenst nicht der von PC 1.0))
  355.     - Die Headerdatei wurde verbessert: Für das reserved-Feld des Cookies 
  356.       existiert jetzt die Konstante RESERVED_SIZE, die die Größe des Feldes 
  357.       angibt.
  358.  
  359.     TOS2GEM vom 12.12.1994:
  360.     - Bei der Berechnung zweier interner Variablen war mir ein kleiner 
  361.       Fehler unterlaufen, der unter bestimmten Umständen zu fehlerhaftem 
  362.       Scrolling führte (wenn von einer Zeile nur die erste Pixelreihe 
  363.       sichtbar war)
  364.     - TOS2GEM-Beispiel in's "große" Archiv aufgenommen, damit man sich auch 
  365.       ein Bild davon machen kann, welchen Zweck TOS2GEM überhaupt hat und 
  366.       wie es arbeitet. Daran hatte ich zuerst nicht gedacht (Dank an Dirk 
  367.       Klemmt, der mich auf dieses Versäumnis hingewiesen hat).
  368.  
  369.     TOS2GEM vom 22.11.1994:
  370.     - Erste offizielle Version, leider noch ohne ST-Guide-Doku (ich wollte 
  371.       TOS2GEM halt auf der proTOS "releasen"...)
  372.     - Unter MagiC wird jetzt das Problem umgangen, daß ein Aufruf von Fread 
  373.       für die Console den "echten" Cursor einschaltet und den von TOS2GEM 
  374.       völlig falsch plaziert. Die Lösung ist zwar unsauber (Schreibzugriff 
  375.       auf die negativen LineA-Variablen), allerdings habe ich keine andere 
  376.       verläßliche Methode gefunden.
  377.     - TOS2GEM hat jetzt das Speicherschutz-Flag "Global", damit es in 
  378.       dieser Hinsicht keine Probleme mit MiNT/MultiTOS gibt.
  379.  
  380.